home *** CD-ROM | disk | FTP | other *** search
/ Aminet 1 (Walnut Creek) / Aminet - June 1993 [Walnut Creek].iso / aminet / gfx / conv / unmovie.lha / unmovie / read.me < prev    next >
Text File  |  1992-06-07  |  2KB  |  55 lines
  1. UNMOVIE is a program which takes a "movie" which was constructed using "dilbm"
  2. and "pilbm" and turns it back into the sequence of standard IFF frames from
  3. which the movie was originally created. I wrote it because a lot of the movies
  4. I created years ago were lost to me because "movie" won't run under 2.0. If
  5. "movie" can display an animation, "unmovie" can take it apart.
  6.  
  7. To see how to invoke it, try running it without parameters.
  8.  
  9. The guy who wrote "dilbm", "pilbm", and "movie" never documented his internal
  10. format, but I figured it out by experimentation.
  11.  
  12. The first major portion of the FORM is a standard IFF of the first frame of the
  13. animation. The rest consists of DLTA's, which are created by "dilbm" and
  14. describe the difference between two IFF's. A DLTA appears to have three kinds
  15. of items in it, with each type being indicated by the value of its first byte:
  16.  
  17.  
  18. Type 0: indicates the end of the DLTA. Layout:
  19.   word: 0
  20.  
  21. Type 1: indicates a "wall": This is a section of the image which has full
  22.     Z-height, is 1 byte wide in X, and has a variable Y size. Layout:
  23.   word: 1
  24.   word: 0=unidirectional (store value), 1=bidirectional (XOR value)
  25.   word: Y-size (number of pixels in Y direction)
  26.   word: number of blocks to follow:
  27.     per block:
  28.     word: offset in each bitplane (note: NOT in the total image!)
  29.     1-6 bytes: full Z height for first Y
  30.     1-6 bytes: full Z height for second Y
  31.     etc., extending DOWN.
  32.  
  33. Type 2: indicates a "pile": This is a section of the image which has full
  34.     Z-height, and has both variable Y size and X size. Layout:
  35.   word: 2
  36.   word: 0=unidirectional, 1=bidirectional
  37.   word: Y size
  38.   word: X size
  39.   word: number of blocks to follow:
  40.     per block:
  41.     word: offset in each bitplane (NOT in the total image)
  42.     successive bytes: a traversed 3D rectangle, with X varying within
  43.     Y within Z. (X moves right, Z moves up, Y moves down)
  44.  
  45. The movie is double-buffered, but you don't have to know about that part.
  46. (Anyway, it is described in the original documentation for "pilbm" if you're
  47. curious.
  48.  
  49.  
  50. "unmovie" is freely redistributable. It isn't blazingly fast, but then, it
  51. really doesn't need to be.
  52.  
  53.         Steven Den Beste
  54.         denbeste@world.std.com
  55.